home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / merge.lqr / MERGE.DOC < prev    next >
Encoding:
Text File  |  1985-06-03  |  3.3 KB  |  79 lines
  1.                        Merge: An Ascii File Merger
  2.  
  3.                             by: Keith Peterson
  4.  
  5.                               Algonquin, IL
  6.  
  7.  
  8.      This program is public domain. Feel free to copy it around, but do 
  9. leave my name attached.
  10.  
  11.                                  Overview
  12.  
  13.      Merge will merge a list of data with a text file, sending the file 
  14. to the printer over and over, external data merged in place, until it 
  15. runs out of external data. Multiple data merges per document are 
  16. allowed. It is a simple utility, but quick, easy to use and VERY 
  17. generic. 
  18.  
  19.      There are a million more powerful print mergers in the world, but 
  20. none that can be customized to the bizarre requirements of the real 
  21. world so quickly.
  22.  
  23.      MergeP is the same program, but prints to the screen rather than
  24. the printer. Nice for figuring out what it will do.
  25.  
  26.  
  27.                          The Rest of the story...
  28.  
  29.  
  30.      Merge is the result of a frustrating attempt to merge a list of 
  31. data generated in any random fashion into a text document. It seems that 
  32. most word processors require exotic extra programs or data labeling, 
  33. thus this utility.
  34.  
  35.      Merge will merge two Ascii files together: a text file and a data 
  36. file. Both can have any name, and a variety of delimiters is acceptable. 
  37.  
  38.      The text file may be generated in any way. If the file can be 
  39. typed to the screen, it will work. Line feeds (ascii 10) will be ignored.
  40.  
  41.      Put a ^ at every location where you intend data to be inserted. 
  42. This character can be replaced by any that you wish to use, just look at 
  43. the source.
  44.  
  45.      The data file is also nothing special. Put a carriage return, a 
  46. tab or a comma between data items. Keep in mind that a tab in most word 
  47. processors will turn into several spaces if it must be CONVERTED to 
  48. ascii. If the word processor works directly on ascii files, it should be 
  49. all right.
  50.  
  51.      To run the program, you need either basic (for the slow, 
  52. uncompiled version) or basrun.exe. Execute the program in the typical 
  53. method for the version you are using and enter the file names of your 
  54. text and data files. Note that extensions ARE required and may be 
  55. anything you desire.
  56.  
  57.      The program will print the text file, and when a ^ is encountered 
  58. will pull the next data element in and send it to the printer. Text file 
  59. print is then resumed.
  60.  
  61.      When the end of the text file is encountered, the file will be 
  62. closed, re-opened and printing started again. This repeats until the 
  63. data file ends. The program counts the number of passes and reports when 
  64. done.
  65.  
  66.      You will need to exercise normal care in lining up your input 
  67. data. I recommend that you put all inputs for each text dump on one 
  68. line, seperated by commas. This will help keep them straight.
  69.  
  70.      This is a simple little utility, but keep it around for the day 
  71. that you find that your favorite word processor really won't merge 
  72. letters with the output of your favorite data base, and the boss says "I 
  73. thought these computers were fast......"
  74.  
  75.                                                  Keith Peterson
  76.                                                  3/5/85
  77.  
  78.  
  79.